QuickTime 3 Reference

Previous | Chapter Top | Chapter Contents | Next

Sprite Track Formats

The following constants represent formats of a sprite track. The value of the constant indicates how override samples in a sprite track should be interpreted. You set a sprite track's format by creating a kSpriteTrackPropertySampleFormat atom.

enum {
    kKeyFrameAndSingleOverride                      = 1L << 1,
    kKeyFrameAndAllOverrides                        = 1L << 2
};


Constant descriptions

kKeyFrameAndSingleOverride

The current state of the sprite track is defined by the most recent key frame sample and the current override sample. This is the default format.

kKeyFrameAndAllOverrides

The current state of the sprite track is defined by the most recent key frame sample and all subsequent override samples up to and including the current override sample.

Sprite Media Atom Types

The following string constants represent atom types for sprite media.

enum {
    kSpriteAtomType                     = 'sprt',
    kSpriteImagesContainerAtomType      = 'imct',
    kSpriteImageAtomType                = 'imag',
    kSpriteImageDataAtomType            = 'imda',
    kSpriteSharedDataAtomType           = 'dflt',
    kSpriteNameAtomType                 = 'name'
    kSpriteURLLinkAtomType              = 'url '
    kSpritePropertyMatrix               = 1
    kSpritePropertyVisible              = 4
    kSpritePropertyLayer                = 5
    kSpritePropertyGraphicsMode         = 6
    kSpritePropertyImageIndex           = 101
    kSpritePropertyBackgroundColor      = 101
    kSpritePropertyOffscreenBitDepth    = 102
    kSpritePropertySampleFormat         = 103
};


Constant descriptions

kSpriteAtomType

The atom is a parent atom that describes a sprite. It contains atoms that describe properties of the sprite. Optionally, it may also include an atom of type kSpriteNameAtomType that defines the name of the sprite.

kSpriteImagesContainerAtomType

The atom is a parent atom that contains atoms of type kSpriteImageAtomType .

kSpriteImageAtomType

The atom is a parent atom that contains an atom of type kSpriteImageDataAtomType . Optionally, it may also include an atom of type kSpriteNameAtomType that defines the name of the image.

kSpriteImageDataAtomType

The atom is a leaf atom that contains image data.

kSpriteSharedDataAtomType

The atom is a parent atom that contains shared sprite data, such as an atom container of type kSpriteImagesContainerAtomType .

kSpriteNameAtomType

The atom is a leaf atom that contains the name of a sprite or an image. The leaf data is composed of one or more ASCII characters.

kSpriteURLLinkAtomType

The atom is a leaf atom that contains the uniform resource locator (URL) of the sprite. The leaf data is a string without a leading length byte or trailing null. The length of the string is the same of the size of the atom, in bytes.

kSpritePropertyImageIndex

A leaf atom containing the image index property which is of type short . This atom is a child atom of the kSpriteAtom .

kSpritePropertyLayer

A leaf atom containing the layer property which is of type short . This atom is a child atom of the kSpriteAtom .

kSpritePropertyMatrix

A leaf atom containing the matrix property which is of type MatrixRecord . This atom is a child atom of the kSpriteAtom .

kSpritePropertyVisible

A leaf atom containing the visible property which is of type short . This atom is a child atom of the kSpriteAtom .

kSpritePropertyGraphicsMode

A leaf atom containing the matrix property which is of type ModifyerTrackGraphicsModeRecord . This atom is a child atom of the kSpriteAtom .

kSpritePropertyBackgroundColor

A leaf atom containing the background color property which is of type RGBColor . This atom is used in a sprite track's MediaPropertyAtom atom container.

kSpritePropertyOffscreenBitDepth

A leaf atom containing the preferred offscreen bitdepth which is of type short . This atom is used in a sprite track's MediaPropertyAtom atom container.

kSpritePropertySampleFormat

A leaf atom containing the sample format property which is of type short . This atom is used in a sprite track's MediaPropertyAtom atom container.